home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / subtex.z / subtex
Encoding:
Text File  |  2002-10-03  |  3.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ssssttttxxxxlllldddd((((3333GGGG))))                                                            ssssttttxxxxlllldddd((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssssttttxxxxlllldddd - load part or all of a texture defined with TX_FASTDEFINE
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ssssuuuubbbbtttteeeexxxxllllooooaaaadddd(((())))
  13.      rrrreeeeaaaallll
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _t_a_r_g_e_t   is the texture target to which the texture we are loading is
  17.               bound.  Currently this must be TX_TEXTURE_0.
  18.  
  19.      _i_d       is the id of the texture we are loading.
  20.  
  21.      _s_0       is the starting S coordinate of the subtexture to load.
  22.  
  23.      _s_1       is the ending S coordinate of the subtexture to load.
  24.  
  25.      _t_0       is the starting T coordinate of the subtexture to load.
  26.  
  27.      _t_1       is the ending T coordinate of the subtexture to load.
  28.  
  29.      _n_t       is number of words in the subtexture array.
  30.  
  31.      _t_e_x_t_u_r_e  is the long word aligned array of texels to load.
  32.  
  33.      _f_l_a_g_s    is a special modifier used for performance-critical, common
  34.               cases such as loading a 64x64 1 component 12bit subtexture with
  35.               one texel per 16bit word.
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      ssssttttxxxxlllldddd loads some or all of a texture that is currently allocated space in
  39.      texture memory.  The transfer uses the pixmode and scale and bias
  40.      settings in effect at the time of the texdef2d if TX_EXTERNAL_FORMAT,
  41.      TX_PIXMODE was specified in the properties.
  42.  
  43.      The values s0,s1,t0,t1 are mapped to texel values by
  44.      start_s_texel = s0*texture_width;
  45.      start_t_texel = t0*texture_height;
  46.      end_s_texel   = s1*texture_width - 1;
  47.      end_t_texel   = t1*texture_height - 1;
  48.  
  49.      s0,s1,t0,t1 should fall on texels that are a multiple of 32, i.e. for a
  50.      texture that is 256x128, s0,s1 can be
  51.      0,.125,.25..375,.5,.625,.750,.875,1.0, while t0,t1 can be
  52.      0.,.25,.50.,75.,1.0. Results are undefined for any other values.
  53.  
  54.      If 1 is passed for flags, the data will be transferred as formatted 16bit
  55.      texels to the graphics system with minimal interpretation, i.e., no scale
  56.      and bias and no pixmode transformations.  A significant gain in transfer
  57.      speed may be achieved for RealityEngine systems.  Only data that is 64
  58.      texels on a side may be sent. A common use of this is to send 64x64 tiles
  59.      of 12 bit intensity data stored in the low bits of a 16bit datum.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssttttxxxxlllldddd((((3333GGGG))))                                                            ssssttttxxxxlllldddd((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      If 2 is passed for flags, 8bit/component ABGR data will be transferred to
  75.      the graphics system with minimal interpretation, i.e., no scale and bias
  76.      and no pixmode transformations.  A significant gain in transfer speed may
  77.      be achieved for RealityEngine systems.  Only data that is 128 texels on a
  78.      side may be sent. A common use of this is to send 128x128 tiles of 32bit
  79.      ABGR data.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82. NNNNOOOOTTTTEEEESSSS
  83.      ssssttttxxxxlllldddd is supported only on RealityEngine systems with release 5.0.1 or
  84.      greater.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.